Format of a single-row survey file
The example below shows a single-row record file.
$VISION
* VisumInst
* 24.07.08
*
*
* Table: Version block
$VERSION:VERSNR;FILETYPE;LANGUAGE;UNIT
4.00;SingleRowSurveyData;ENG;KM
* Table: Single-row survey data
$SingleRowSurveyData:No;Type;SurveyLineName;SurveyLineDirCode;SurveyLineRouteName;SurveyTimeProfileName;PreTSysCode;PreLineName;PreLineDirCode;PreLineRouteName;PreTimeProfileName;SucTSysCode;SucLineName;SucLineDirCode;SucLineRouteName;SucTimeProfileName;InputStopNo;InputStopDepDay;InputStopDepTime;OrigZoneNo;OrigStopNo;PreStopNo;BoardStopNo;AlightStopNo;SucStopNo;DestStopNo;DestZoneNo;NumPass; ExtProjFac
1;0;Train;H;1;;B;BUS1;H;1;1;;;;;;;;5;1;6:26:00;;30;10;20;40;;40;;17;
2;0;Train;R;1;1;;;;;;;;;;;;;5;1;6:25:00;100;;10;20;40;;40;;29;
3;99;Train;H;1;1;B;;;;;;;;;;5;1;6:25:00;;;;10;10;20;40;;40;;33;
4;0;BUS1;H;1;1;B;BUS1;H;1;1;;;;;;5;1;6:15:00;;;;10;20;30;40;;40;;18;
5;0;BUS1;H;1;1;;;;;;Z;Train;R;1;1;5;1;6:05:00;1;6:10:00;;10;;10;20;;40;;15;3
The following combinations of input attributes can serve as keys in the file. Then they are mandatory attributes:
- BoardStopNo, AlightStopNo, BoardStopNo, InputStopDepTime and InputStopDepDay / InputStopDepDate
- SurveyVehJourneyNo, BoardStopNo, AlightStopNo, InputStopNo and InputStopDepDay / InputStopDepDate
When employing this combination, Visum checks whether a vehicle journey item of the specified vehicle journey exists, which departs at the specified stop in the specified combination of time and day. This vehicle journey item is used as survey path leg from the BoardStopNo to the AlightStopNo if the vehicle journey serves this stop.
- SurveyVehJourneyNo, BoardVehJourneyItemIndex, AlightVehJourneyItemIndex and InputStopDepDay / InputStopDepDate
The survey path leg is identified. A vehicle journey is required which departs at the BoardVehJourneyItemIndex on the same day. If no suitable departure exists, the survey path leg is not plausible.
- SurveyVehJourneyNo, BoardVehJourneyItemIndex and InputStopDepDay / InputStopDepDate
Similar to the key described above. The item following the BoardVehJourneyItemIndex is considered the end of the path leg.
The following table describes the input attributes of a single-row survey data record file.
Attribute |
Description |
|
No. |
Number of the data record |
|
Type |
Data record type, serves for filtering during plausibilization (Default: 0) |
|
SurveyVehJourneyNo |
Number of the vehicle journey of the survey line |
|
SurveyLineName |
Key of the survey line, consisting of 4 compounds. These attributes need to match. |
Name of the survey line |
SurveyLineDirCode |
Direction code of survey line |
|
SurveyLineRouteName |
Name of the surveyed line route |
|
SurveyTimeProfileName |
Name of the surveyed time profile |
|
PreTSysCode |
Code of the preceding line’s TSys |
|
PreLineName |
Four-part key of the prec. leg These attributes need to match. |
Name of the preceding line |
PreLineDirCode |
Direction code of the preceding line |
|
PreLineRouteName |
Name of the preceding line route |
|
PreTimeProfileName |
Name of the preceding time profile |
|
SucTSysCode |
Code of the succeeding line’s TSys |
|
SucLineName |
Four-part key of the succ. leg These attributes need to be consistent with each other. |
Name of the succeeding line |
SucLineDirCode |
Direction code of succeeding line |
|
SucLineRouteName |
Name of the succeeding line route |
|
SucTimeProfileName |
Name of the succeeding time profile |
|
InputStopDepTime |
Time of departure time of the survey line from the stop specified as InputStopNo. |
|
InputStopDepDay |
Day of departure of the survey line from the stop specified as InputStopNo. |
|
InputStopDepDate |
Day of departure of the survey line from the stop specified under InputStopNo. If this attribute is available, it is converted into a calendar day index value according to the calendar used and entered into the attribute InputStopDepDay. |
|
InputStopNo |
Number of the stop in the survey line, to which the values InputStopDepTime and InputStopDepDay refer. |
|
OrigZoneNo |
Number of the passenger’s origin zone. If the OrigStopNo is also defined, both numbers have to match: At least one stop area of the stop needs to be allocated to a node which is connected to the zone. |
|
OrigStopNo |
Number of the start stop of the passenger trip. If the OrigStopNo is missing, PreStopNo = OrigStopNo is assumed. |
|
PreStopNo |
Number of a preceding stop (transfer stop) of the passenger trip. |
|
BoardVehJourneyItemIndex |
Index of the vehicle journey boarding item of the survey line |
|
AlightVehJourneyItemIndex |
Index of the vehicle journey alighting item of the survey line |
|
BoardStopNo |
Number of the stop where the passenger boarded the survey line. |
|
AlightStopNo |
Number of the stop where the passenger will alight the survey line. |
|
SucStopNo |
Number of a succeeding stop (transfer stop) of the passenger trip. |
|
DestStopNo |
Number of the passenger’s destination stop. If the DestStopNo is missing, SucStopNo = DestStopNo is assumed. |
|
DestZoneNo |
Number of the passenger’s destination zone. If the DestStopNo is also defined, both numbers have to match: At least one stop area of the stop needs to be allocated to a node which is connected to the zone. |
|
NumPassengers |
Number of boarding persons per ticket (= one data record, default value: 1) |
|
ExtProjFactor |
Via the external projection factor, external passenger weights can be taken into account. |